home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util1 / syspc211.lha / SysPic / SysPic.doc < prev    next >
Text File  |  1995-12-18  |  14KB  |  413 lines
  1.  
  2.              --------------------------------------------------
  3.  
  4.                              »»» SysPic v2.11 «««
  5.                           "Make your boot look cute!"
  6.  
  7.                        Cardware © 1995 The Beet Research
  8.  
  9.                          written by Grzegorz Calkowski
  10.  
  11.       -----------------------------------------------------------------
  12.  
  13.  
  14. Disclaimer
  15. ----------
  16.  
  17.     The program executable and information above is provided "as is".  No
  18. representations or warranties are made with respect to the accuracy,
  19. reliability, performance, currentness, or operation of this software and
  20. information, and all use is at your own risk.  The author doesn't assume any
  21. responsibility or liability whatsoever with respect to your use of the program
  22. and information.
  23.  
  24.  
  25. Copying
  26. -------
  27.  
  28.     SysPic is now CardWare (no longer, hmhm, BeetWare...).  This means your are
  29. *OBLIGED* to send me a postcard if you use it regulary.  (BTW:  if you use
  30. SysPic, it's probably the most frequently used proggie, isn't it?) Treat the
  31. card as a shareware fee.  Or, if sending a postcard sounds to you too
  32. complicated you can e-mail me a message saying that SysPic is the coolest
  33. program you have ever used :-).
  34.  
  35.                               --- WARNING!!! ---
  36.  USING THE PROGRAM WITHOUT SENDING A POSTCARD OR AN E-MAIL LETTER IS ILLEGAL. 
  37.  
  38. This program can be freely distributed under following conditions:
  39.  
  40.         1. Everything in this distribution must be kept together and
  41.            unaltered. Applies to:
  42.  
  43.            Bonus/Bonus.readme           (readme about included pics)
  44.            Bonus/windows1.ilbm
  45.            Bonus/windows2.ilbm
  46.            Bonus/windows3.ilbm
  47.            Bonus/windows4.ilbm
  48.            Bonus/windows5.ilbm
  49.            C/SysPic                     (the program itself)
  50.            C/SysPic.020                 (68020+ version)
  51.            C/SysPic.040                 (68040+ version)
  52.            C.info
  53.            Install SysPic               (installer script)
  54.            Install SysPic.info
  55.            SysPic.doc                   (plain ASCII doc)
  56.            SysPic.doc.info
  57.            SysPic.guide                 (AmigaGuide®'d doc)
  58.            SysPic.guide.info
  59.            WBStartup/ClosePic           (command removing the picture)
  60.            WBStartup/ClosePic.info      (its icon - MWB style)
  61.            WBStartup.info
  62.  
  63.         2. Copyright notices are not removed from executable and
  64.            documentation.
  65.  
  66.         3. No more than a nominal fee is charged to cover cost of magnetic
  67.            media.
  68.  
  69. SysPic is Copyright (C) 1995 The Beet Research. All rights reserved.
  70.  
  71.  
  72. Introduction
  73. ------------
  74.  
  75.     If you think that black screen during boot time is boring and you want make
  76. the boot look more professional (or even fancy) it is definitely program for
  77. you. I know there are other similar programs - but SysPic's features make it
  78. absolutely the BEST!
  79.  
  80.     SysPic is a small viewer-like program meant to show a picture during the
  81. boot time.  The picture can be removed at any time using an independent command
  82. (ClosePic) which can be placed for example in your WBStartup drawer.
  83.  
  84.     Features - SysPic
  85.  
  86.       o is small & fast
  87.  
  88.       o shows IFF-ILBM pictures of any size and resolution
  89.  
  90.       o supports AGA modes (also HAM8)
  91.  
  92.       o centers picture both horizontally & *vertically*
  93.  
  94.       o forces Workbench to open behind the displayed picture so it can be
  95.         closed after whole Workbench initialization
  96.  
  97.       o blanks the pointer sprite so you won't see it when the Workbench
  98.         screen activates (it would look annoying) (see Bugs)
  99.  
  100.       o has a nice random number generator
  101.  
  102.       o detaches from shell in an intelligent way (i.e after loading
  103.         the picture)
  104.  
  105.       o !!!COOL-> sets overscan prefs before IPrefs will do it. <-COOL!!!
  106.  
  107.       o supports BeetLogin (closes it's 'fake' screen)
  108.  
  109.       o is 100% legal
  110.  
  111.       o has been tested with Enforcer, Mungwall & MemWatch
  112.  
  113.  
  114. Requirements
  115. ------------
  116.  
  117.     SysPic requires at least Kickstart 3.0 (no time for 2.04 compatibility,
  118. sorry).  It makes not much sense to use it without harddisk.  Memory
  119. requirement depends on size and no.  of colours of displayed picture.
  120.  
  121.     SysPic uses iffparse.library which should be installed in your LIBS:.
  122. The library comes with your Workbench package.
  123.  
  124.  
  125. Installation
  126. ------------
  127.  
  128.     It's fairly easy.  First copy file 'SysPic' whereever you want.  I
  129. recommend you to put it to C:  or somewhere else on your command path.  Then
  130. add to your 'startup-sequence' following line:
  131.  
  132.         SysPic <picture> <options>
  133.  
  134.     As of version 2.00 SysPic sets the overscan prefs so you can put it right
  135. after SetPatch (recommended).
  136.  
  137.     In order to remove opened picture, the small program 'ClosePic' is needed.
  138. Simply drop it to 'WBStartup' drawer, which is the best suitable place for it.
  139. To have picture closed when whole Workbench is initialized set STARTPRI
  140. tooltype to -128.  It assures that 'ClosePic' will be launched last (for your
  141. convinience it is already set to -128 :).
  142.  
  143.     In version 2.10 ClosePic has got a tooltype - 'DELAY=xxx' which allows to
  144. delay picture closing, where 'xxx' is ticks amount (1 second = 50 ticks).  For
  145. example:
  146.  
  147.         DELAY=150
  148.  
  149. causes 3 second delay. This option is unavailable from Shell. 
  150.  
  151.     If you don't put it to 'WBStartup' drawer you have to add following line at
  152. the end of 'startup-sequence':
  153.  
  154.         ClosePic
  155.  
  156.     Note, that there is 68020 version supplied. Use it if you have 68020 or
  157. 68030 based Amiga. For higher CPUs there is 68040 version.
  158.  
  159.  
  160. Usage
  161. -----
  162.  
  163.     The main program - 'SysPic' can be used only from Shell.  It makes not much
  164. sense to use it from Workbench (for what ?).  Therefore don't try to launch it
  165. from WB because it will do nothing (at least it won't crash the machine).
  166.  
  167.     The options template for 'SysPic' looks like:
  168.  
  169.         Picture/A,RandMin/N,RandMax/N,Digits/N,BF=BestFit/S,SO=SetOscn/S,
  170.         KP=KeepPtr/S,VC=VCenter/S,BB=BBlank/S
  171.  
  172.     where
  173.  
  174.         Picture <path>          Specifies the filepath for an IFF-ILBM picture.
  175.                                 Note, that 'Picture' keyword can be omitted.
  176.  
  177.                                 If you specify an asterisk (*) in the name it
  178.                                 will be replaced with randomly generated
  179.                                 number. In such case you have to specify both
  180.                                 'RandMin' and 'RandMax'.
  181.  
  182.         RandMin <number>        Lower bound for random generator
  183.  
  184.         RandMax <number>        Upper bound for random generator
  185.  
  186.         Digits <size>           Specifies how many digits will be inserted.
  187.                                 If length of generated number is shorter than
  188.                                 specified size it will be filled with leading
  189.                                 zeros.
  190.  
  191.         BF or BestFit           Switch - if specfied program will use
  192.                                 BestModeIDA() function of Kickstart 3.0+
  193.                                 to get the best resolution for the picture.
  194.  
  195.                                 It sometimes can give unexpected results.
  196.                                 Generally it's better to save the picture in
  197.                                 the desired viewmode.
  198.  
  199.         SO or SetOscn           Sets your overscan preferences (from
  200.                                 envarc:sys/overscan.prefs file). It avoids
  201.                                 the very annoying screen-jump when IPrefs sets
  202.                                 the overscan prefs. It's very usable when you
  203.                                 want to display a picture in a multisync mode
  204.                                 like DBLPAL or MULTISCAN, which overscan
  205.                                 preferences usually differ from the defaults.
  206.                                 Note, it's a hack! See Bugs.
  207.  
  208.         KP or KeepPtr           Switch - if specified the mouse pointer won't
  209.                                 be blanked.
  210.         
  211.         VC or VCenter           Switch - enables vertical centering. Usable for
  212.                                 displaying brushes - saves space & time.
  213.  
  214.         BB or BBlank            Switch - turns blank border around the SysPic's
  215.                                 screen.
  216.  
  217.  
  218.     The 'ClosePic' can be used from Workbench as well what is recommended.
  219. Simply put it into 'WBStartup' drawer and forget about it.  See Instalation.
  220.  
  221.     Well, in fact, SysPic is full-featured viewer.  It can display any ILBM
  222. image upto 256 colours and HAM6/HAM8 images as well.  IFF parsing routines are
  223. based on orginal C= routines.
  224.  
  225.     From version 2.03 SysPic's screen is public.  Useful if you want to open a
  226. fancy MultiUserFileSystem login on it, for example.  The screen's name is
  227. 'SysPic' (logical, eh?).
  228.  
  229.  
  230. To Do
  231. -----
  232.  
  233.     No ideas. I think the proggie is complete
  234.                                 (I've told it in 2.02 release... :-)
  235.  
  236.     But if you have some suggestions...?
  237.  
  238.  
  239. Bugs
  240. ----
  241.  
  242.     Sprite blanking is still not perfect.  Why?  Normally it's no problem to
  243. get rid of sprites - it can be done by disabling sprite DMA or just by setting
  244. a window's mouse pointer to an invisible one.  It works fine :-).  But no if
  245. another program is poking in sprite stuff in the background.  And this is the
  246. case, because IPrefs does so (it changes display params with VideoControl(),
  247. namely).  The only thing I could do was an interrupt server, which was turning
  248. off sprite DMA subsequently.  I have no other ideas!  If you know a better one
  249. _please_ contact me!!
  250.  
  251.     Another thing, not really a bug - overscan prefs.  Starting from Release 2
  252. there are no documented methods for setting preferences.  The only program in
  253. universe able to do it is IPrefs.  Well, everything can be done :-) SysPic sets
  254. the overscan prefs EXACTLY in the same way as IPrefs does.  But this can be
  255. considered as kind of hack.  Well, works fine under V39 & V40, however, this
  256. maybe not be the case under future releases of Kickstart.
  257.  
  258.  
  259. Contacting the author
  260. ---------------------
  261.  
  262.     Any ideas, bug reports, donations, hardware (for example Cyberstorm
  263. turboboard for my A4000), etc.  will be sincerely welcomed.  Just contact me!
  264.  
  265.     My addy:
  266.                 Grzegorz Calkowski
  267.                 Rzedowice
  268.                 ul.Dobrodzienska 8
  269.                 42-780 Dobrodzien
  270.                 POLAND
  271.  
  272.     Phone:      +48(0)34-575875
  273.  
  274.     E-mail:     calkowsk@us.edu.pl
  275.  
  276. (Sorry, for my poor English...)
  277.  
  278.  
  279. Always remember:
  280. ----------------
  281.  
  282.         Beeting is beliving...
  283.  
  284.         and Amiga is the best computer ever!
  285.  
  286.  
  287. Acknowledgements
  288. ----------------
  289.  
  290. Thanks go to:
  291.  
  292.    o  Michal Prochownik for general support & for the game idea
  293.       (We WILL make it!)
  294.  
  295.    o  Ryszard "Justus" Baginski for ClosePic's icon.
  296.  
  297.    o  Jacek "Plexa" Miklasiewicz for the job...
  298.  
  299.    o  Jacek "Shind" Grzegorczyk for the 340MB HDD (really nice gift 8-)
  300.  
  301.    o  Stefano Peruzzi, Aaron Robinson, Christian Kemp, Javier Rodrguez Cos,
  302.       G.Nath for their constructive suggestions.
  303.  
  304.    o  For develop team at C= (R.I.P) for the wonderful machine.
  305.  
  306.    o  ESCom for Amiga Technologies.
  307.    
  308.  
  309.  
  310. History
  311. -------
  312.  
  313. v1.00ß (22.07.95)
  314.  
  315.     o First BETA release.
  316.  
  317.  
  318. v1.50 (25.08.95)
  319.  
  320.     o not "historized" and not released
  321.  
  322.  
  323. v2.00 (30.08.95)
  324.  
  325.     ** not released to public
  326.  
  327.     o Now SysPic automatically detaches from current Shell process. It does it
  328.       in intelligent way, i.e exits after the picture is loaded & displayed.
  329.  
  330.     o Added random generator. New options: RANDMIN, RANDMAX, DIGITS.
  331.  
  332.     o Added feature of setting overscan prefs before IPrefs will do that!
  333.       (New option: SETOSCN). It's a hack! See Bugs.
  334.  
  335.     o Sprite blanking works better but it is still unreliable.
  336.  
  337.     o Added shortcut for BESTFIT - BF.
  338.  
  339.  
  340. v2.01 (05.09.95)
  341.  
  342.     ** not released to public
  343.  
  344.     o Improved sprite blanking. A little, in fact :-). See Bugs.
  345.  
  346.  
  347. v2.02 (27.09.95)
  348.  
  349.     o Added support for my other utility - BeetLogin. Automatically closes
  350.       'fake' screen leftover by it.
  351.  
  352.     o In some cases SysPic didn't display error messages (ie "Not IFF file").
  353.       Fixed.
  354.  
  355.     o Rendezvous port priority set to a high value to improve ClosePic's
  356.       performance.
  357.  
  358.     o Documentation updated.
  359.  
  360.     o Finally released... (and probably the final release... :-)
  361.  
  362.  
  363. v2.03 (27.11.95)
  364.  
  365.     o Now SysPic's screen is public screen. (Requested by Stefano Peruzzi).
  366.  
  367.     o For the same reason 'KEEPPTR' switch added. If specified the pointer
  368.       won't be blanked. 
  369.  
  370.     o SysPic always lost 8 bytes of memory due to the patching of
  371.       intuition/OpenScreenTagList() function. Now it losts them only if
  372.       another program patches the same function.
  373.  
  374.     o Optimized a bit (saved over 512 bytes :-)
  375.  
  376.  
  377. v2.10 (14.12.95)
  378.  
  379.     o Veritcal centering option added - 'VCenter'. (Requested by Aaron
  380.       Robinson and several other people)
  381.  
  382.     o Border blanking option added - 'BBlank'. (Suggested by Christian Kemp)
  383.  
  384.     o Options changed to mixed-case (increases readability).
  385.  
  386.     o ILBM unpacker rewritten in machine code. A bit faster :).
  387.  
  388.     o 68040+ version included
  389.  
  390.     o 'DELAY' option added in ClosePic. (Suggested by Javier Rodrguez Cos)
  391.  
  392.     o Version string included in ClosePic.
  393.  
  394.     o Bonus pictures cropped to used area (now smaller, but need 'VCenter'
  395.       option to be centered correctly).
  396.  
  397.     o Further optimizations made saving some bytes (again smaller than previous
  398.       version!)
  399.  
  400.     o Installer script included (finally...)
  401.  
  402.  
  403. v2.11 (18.12.95)
  404.  
  405.     o Ooopsss... vertical centering had been working until final compilation...
  406.       really stupid bug. Fixed.
  407.  
  408.     o Error messages sometimes were doubled (strange, indeed). Fixed.
  409.  
  410.     o Documentation updated...  I didn't write that ClosePic's DELAY tooltype
  411.       value is expressed in ticks.
  412.  
  413.